home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 476-500 / disk_497 / mouseblanker / mausweg.dok < prev    next >
Text File  |  1992-05-06  |  10KB  |  236 lines
  1.  
  2.                                Mausweg
  3.  
  4.                              (Commodity)
  5.  
  6.                                  von
  7.  
  8.                             Stefan Sticht
  9.  
  10.           Dieses Programm, Quellcode und Dokumentation sind
  11.  
  12.                             PUBLIC DOMAIN.
  13.  
  14.  
  15.                Sie können damit machen, was Sie wollen!
  16.  
  17.  
  18. Der Zweck dieses Commodities:
  19. ---------------------------
  20. Mausweg  ist  ein Commodity, das den Mauspfeil verschwinden läßt, wenn
  21. die  Maus eine bestimmte Zeit nicht mehr bewegt wurde oder wenn irgend
  22. eine  Taste  der  Tastatur gedrückt wird.  Der Pfeil erscheint wieder,
  23. sobald  Sie  die  Maus bewegen.  Damit soll verhindert werden, daß der
  24. Mauspfeil Informationen verdeckt, was er meistens macht.
  25.  
  26. Systemanforderungen:
  27. --------------------
  28. Dieses  Commodity  erfordert  mindestens  Kickstart 37.* und Workbench
  29. 37.*.   Bitte prüfen Sie dies, indem Sie in der Shell Version eingeben
  30. oder  im  Workbench  Menü  About  aufrufen.   Außerdem  muß  sich  die
  31. commodities.library  in Ihrem Verzeichnis libs:  befinden.  Überprüfen
  32. Sie  dies  bitte,  indem  Sie  in  der  Shell  den  Befehl "dir libs:"
  33. eingeben.
  34.  
  35. Und so startet man ein Commodity:
  36. ---------------------------------
  37. Es  gibt  grundsätzlich  zwei  verschiedene  Arten,  ein  Commodity zu
  38. starten:  von der Workbench oder von der Shell aus.
  39.     Das Starten von der Workbench aus ist äußerst einfach:  Machen Sie
  40. einen  Doppelklick  auf  dessen Icon und das Commodity wird gestartet.
  41. Eventuell  wollen  Sie verschiedene Parameter eines Commoditys ändern.
  42. Dazu  benutzen  Sie  Tool-Types.  Tool-Types ändern Sie, indem Sie das
  43. Commodity  Icon einmal anklicken und im Menü der Workbench Information
  44. aufrufen.   In  dem  Fenster, daß sich öffnet, sehen Sie die Liste der
  45. Tool-Types.   Wie  Sie die Tool-Types ändern, lesen Sie bitte in Ihrer
  46. Workbench-Dokumentation   nach.    Welche  Parameter  Sie  für  dieses
  47. Commodity ändern können, wird später beschrieben.
  48.     Bitte  beachten Sie, daß ein weiterer Doppelklick auf das Icon des
  49. Commoditys,  während es bereits läuft, bewirkt, daß das Commodity sein
  50. Fenster  öffnet.   Da  es  nicht  sinnvoll  wäre  Mausweg  zweimal zur
  51. gleichen Zeit laufen zu lassen, ist dies auch nicht möglich.  Wenn Sie
  52. die   Tool-Types  in  irgendeiner  Weise  verändern,  nachdem  Mausweg
  53. gestartet  wurde,  wird  ihm  diese Veränderung nicht mitgeteilt.  Sie
  54. müssen ein bereits laufendes Mausweg verlassen und neu starten.
  55.     Um  ein  Commodity in der Shell zu starten, geben Sie dessen Namen
  56. ein.   Sollten  Sie  die Fehlermeldung "Unknown command ???" erhalten,
  57. haben  Sie  sich  beim  Commodity-Namen  vertippt  oder  das Commodity
  58. befindet sich nicht in ihrem aktuellen Verzeichnis bzw.  dem aktuellen
  59. Suchpfad.    Am   einfachsten   ist   es,   das  aktuelle  Verzeichnis
  60. mit dem Befehl "CD" dorthin zu ändern, wo das Commodity sich befindet.
  61. Sie  können  die Parameter eines Commodity mit Befehlsoptionen ändern.
  62. Die  verfügbaren  Optionen  können Sie sich anzeigen lassen, indem Sie
  63. ein ?  als ersten Parameter angeben:
  64.  
  65.                               Mausweg ?
  66.  
  67. gibt Ihnen eine Liste der Befehlsoptionen.  Die Erklärung jeder Option
  68. erfolgt  später.  Startet man das Commodity, während es bereits läuft,
  69. erreicht  man  wiederum, daß es sein Fenster öffnet.  Dabei wird keine
  70. der angegebenen Befehlsoptionen berücksichtigt.
  71.  
  72.     Wenn  Sie  wünschen,  daß  das  Commodity  bei  jedem Boot-Vorgang
  73. gestartet  wird, sollten Sie folgende Zeile in Ihre User-Startup Datei
  74. einfügen:
  75.  
  76.                        <Pfad>Mausweg <Optionen>
  77.  
  78. Vergessen  Sie  bitte  nicht  für  <Pfad>  den  tatsächlichen Pfad zum
  79. Commodity   und   für   <Optionen>   die  gewünschten  Befehlsoptionen
  80. anzugeben.   Folgendes  Beispiel  startet  Mausweg,  wenn  es  sich im
  81. Schubladen Tools der Boot-Diskette befindet, so  daß der der Mauspfeil
  82. nach fünf Minuten verschwindet:
  83.  
  84.                        Tools/Mausweg SEKUNDEN=5
  85.  
  86.     Eine  andere  Möglichkeit,  um  das  Commodity bei jedem Booten zu
  87. starten,  ist,  das  Icon  von Mausweg in den Schubladen WBStartup der
  88. Boot-Diskette   (Workbench)   zu   verschieben.   Das  Commodity  wird
  89. dann   bei   jedem   Boot-Vorgang  gestartet,  als  hätten  Sie  einen
  90. Doppelklick  auf das Icon durchgeführt.  Allerdings müssen Sie im Icon
  91. das Tool-Type DONOTWAIT ergänzen.
  92.  
  93. Benutzung von Exchange:
  94. -----------------------
  95. Exchange  ist  das  Programm,  mit  dem  Commodities verwaltet werden.
  96. Starten  Sie Exchange, das sich für gewöhnlich im Utilities Schubladen
  97. Ihrer  Boot-Diskette  befindet, mit einem Doppelklick auf dessen Icon.
  98. Es  wird Ihnen nun eine Liste aller verfügbaren Commodities angezeigt,
  99. aus  der  Sie  das  entsprechende  Commodity  auswählen können.  Unter
  100. dieser  Liste  wird  nach  Auswahl eines Commodities automatisch desen
  101. Titel, Beschreibung und Status angezeigt.
  102.     Sie   können   nun   Commodities   völlig   beenden   mit  "Kill",
  103. vorübergehend  ausschalten  mit  "Disable"  und wieder einschalten mit
  104. "Enable".   Wenn  das  Commodity  ein  Fenster  öffnen kann, indem für
  105. gewöhnlich Parameter eingestellt werden, können Sie dieses Fenster mit
  106. "Show" öffnen lassen und mit "Hide" schließen lassen.
  107.  
  108.  
  109.                        Veränderbare Parameter:
  110.                        -----------------------
  111.  
  112. CX_Priority:
  113. ------------
  114. Mit  dem  Tool-Type  oder der Befehlsoption CX_PRIORITY=<p> können Sie
  115. die  Priorität  des  Commodities  innerhalb  der Liste der Commodities
  116. bestimmen.   Setzen  Sie  für <p> bitte einen positiven dezimalen Wert
  117. ein. Die voreingestellte Priorität ist 0.
  118.  
  119. Sekunden:
  120. ---------
  121. Mit  der Befehlsoption bzw.  dem Tool-Type Sekunden=<s> können Sie die
  122. Sekunden  einstellen,  die  verstreichen  müssen,  bis  der  Mauspfeil
  123. verschwindet.   <s>  ersetzen  Sie  bitte  durch einen positiven dezi-
  124. malen  Wert.   Sekunden=0  schaltet  diese Option aus.  Voreingestellt
  125. sind 3 Sekunden.
  126.     Wenn Sie Mausweg bereits gestartet haben, so können Sie die Anzahl
  127. der  Sekunden  auch  in einem Fenster einstellen, das Sie mit Exchange
  128. öffnen  können.   Starten  Sie  Exchange, wählen Sie aus der Liste der
  129. Commodities  Mausweg,  und drücken Sie den "Show" Schalter.  Jetzt hat
  130. sich  das  Fenster von Mausweg geöffnet.  Hier können Sie die Sekunden
  131. ändern,  das  Fenster wieder verschwinden lassen mit "Verstecken" oder
  132. Mausweg beenden mit "Beenden".
  133.  
  134. Tastendruck:
  135. ------------
  136. Mit  der  Befehlsoption bzw.  dem Tool-Type TASTENDRUCK=JA|NEIN können
  137. Sie  einstellen, ob durch das Drücken einer Taste auf der Tastatur der
  138. Mauspfeil  sofort versteckt werden soll.  JA|NEIN steht dafür, daß Sie
  139. entweder   JA   oder   NEIN,   aber  nichts  anderes  angeben  können.
  140. Voreingestellt  ist  JA.   Diese Option können Sie auch im Fenster von
  141. Mausweg ändern.
  142.  
  143. CX_Popkey:
  144. ----------
  145. Mit CX_Popkey=<Taste> können Sie ein Tastaturkürzel bestimmen, mit dem
  146. Sie das Fenster von Mausweg öffnen können.  Bitte ersetzen Sie <Taste>
  147. durch  eine  Eingabebeschreibung,  die  unten  erklärt wird.  Wenn Sie
  148. diese  Option  weglassen, wird kein Tastaturkürzel installiert und der
  149. Speicherverbrauch wird etwas reduziert.
  150.  
  151. Beispiele:
  152.  
  153.     CX_POPKEY=f1                (F1 öffnet das Fenster)
  154.     "CX_POPKEY=lshift f1"       (linke Shift-Taste und F1)
  155.     "CX_POPKEY=alt m"           (eine Alt-Taste und die Taste M)
  156.  
  157. CX_Popup:
  158. ---------
  159. Mit  CX_POPUP=JA|NEIN  können Sie bestimmen, ob beim Start von Mausweg
  160. dessen  Fenster  geöffnet  werden  soll.   JA|NEIN  heißt,  Sie können
  161. entweder  JA oder NEIN einsetzen, aber nichts anderes.  Voreingestellt
  162. ist NEIN.
  163.  
  164.                         Eingabebeschreibungen
  165.                         ---------------------
  166.                      (input description strings)
  167.  
  168. Mit   Eingabebeschreibungen   können   Sie   fast  jede  Eingabeaktion
  169. beschreiben,  z.B.   die Aktion lshift f1.  Dies heißt, daß die Aktion
  170. das drücken der Taste F1 zusammen mit der linken Shift-Taste ist.  Bei
  171. diesem Commodity öffnet die Aktion das Fenster des Commoditys.
  172.  
  173. Eingabebeschreibungen haben folgendes Muster:
  174.       [class] (([-]qual)|syn)* [[-]upstroke] [highmap|ANSIcode]
  175.  
  176. (* bedeutet keine oder mehrere Vorkommen des Ausdrucks in Klammern)
  177.  
  178. class   ("Klasse") ist einer der folgenden Ausdrücke:
  179.         rawkey, rawmouse, event, pointerpos, timer, newprefs,
  180.         diskremoved, diskinserted.
  181.         Wenn die Klasse nicht bestimmt wird, wird rawkey angenommen.
  182.  
  183. qual    (qualifier, "Qualifizierer") ist einer der folgenden Ausdrücke:
  184.         lshift, rshift, capslock, control, lalt, ralt, lcommand,
  185.         rcommand, numericpad, repeat, midbutton, rbutton, leftbutton,
  186.         relativemouse
  187.         Ein vorangestelltes "-" bedeutet, daß der folgende Qualifier
  188.         als irrelevant angenommen werden soll.
  189.  
  190. syn     ("Synonym") ist einer dieser Ausdrücke: shift, caps, alt
  191.         shift bedeutet linke oder rechte Shift-Taste
  192.         caps bedeutet Shift oder Caps-Lock
  193.         alt bedeutet linke oder rechte Alt-Taste
  194.  
  195. upstroke (wörtlich "upstroke")
  196.         Wenn dieser Ausdruck fehlt, zählt das Drücken einer Taste für
  197.         die Klassen rawmouse und rawkey. Wenn der Audruck vorhanden
  198.         ist, zählt das Loslassen einer Taste. Stellt man ein "-"
  199.         voran, so zählt beides.
  200.  
  201. highmap ist einer der folgenden Ausdrücke:
  202.         comma, space, backspace, tab, enter, return, esc, del, up, down,
  203.         right, left, help, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10,
  204.         0, 1, 2, 3, 4, 5, 6, 7, 8, 9, (, ), /, *, -, +
  205.  
  206. ansicode ein einzelnes Zeichen steht genau für die entsprechende
  207.         Taste
  208.  
  209. Some full examples:
  210. -------------------
  211.  
  212.     Mausweg sekunden=10
  213.     Mausweg sekunden=5 "cx_popkey=ctrl 1" cx_popup=ja
  214.     Mausweg sekunden=15 "cx_popkey=help"
  215.  
  216.  
  217.  
  218.      Schicken Sie Fehlerreports, Erweiterungswünsche, Fragen und
  219.      -----------------------------------------------------------
  220.                            Geschenke(!) an:
  221.                            ----------------
  222.  
  223.                             Stefan Sticht
  224.                           Bibereckerweg 40a
  225.                            D-8390 Passau 18
  226.                                  FRG
  227.  
  228. oder (besser) an eine der folgenden EMail-Adressen:
  229. Internet: cbmvax.commodore.com!cbmehq!cbmger!edith!sticht@rutgers.EDU
  230.       or: IWSTICHT@ibm.rz.uni-passau.de
  231. Fido-Net: Stefan Sticht (2:242/16:4)
  232.  
  233. Bitte nennen Sie bei einem Fehlerreport auch die Versionsnummer.
  234. Diese erhalten Sie z.B. mit dem Befehl "Version":
  235.                      Version [<path>]<commodity>
  236.